Desktop Images Scripted Actions

Nerdio Manager enables you to execute scripts on desktop images.

Note: You can execute a scripted action immediately or run it on a schedule.

To execute a scripted action:

  1. From the main menu, select Desktop Images.

  2. From the action menu, select Run script.

  3. Enter the following information:

    • Schedule: Toggle to turn the scheduler On/Off. See Manage Schedules for Tasks for details about creating a schedule.

    • Scripted Actions: From the drop-down list, select the script you wish to run.

      Note:

      • Windows scripts are executed via the Azure Custom Script extension and run in the context of the LocalSystem account.

      • Azure runbooks are executed via the Azure automation account and run in the context of the Nerdio Manager app service principal.

      • The following variables are passed to the script and can be used in the PowerShell commands:

        • $AzureSubscriptionId

        • $AzureSubscriptionName

        • $AzureResourceGroupName

        • $AzureRegionName

        • $AzureVMName

        • $ADUsername (if passing AD credentials)

        • $ADPassword (if passing AD credentials)

        • $SATrigger = "RunOnce"

        • $SATriggerMode = "Manual" | "Schedule"

        • $DesktopImageVmName

        • $DesktopImageActiveVersion

        • $DesktopImageStagedVersion

    • Scripted actions input parameters: If necessary, provide the required parameters.

    • Pass AD credentials: Select to pass your AD credentials to the script being executed.

    • Restart VM after script execution: Select to restart the VM after script execution.

      Note: It is preferable to select this option instead of restarting the VM in your PowerShell commands because the Custom Script extension fails if the script restarts the VM.

  4. Once you have entered all the desired information, select either Run now to execute immediately or Save & close to save the script and execute as per the schedule.